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QODBC Limited Use Software License 



LICENSE: 

LICENSER grants to you a limited, non-exclusive license to (i) install and operate the copy of the computer 
program contained in this package ("Program") on a single computer (one central processing unit) and (ii) make 
archival copies of the Program for back-up purposes only for use with the same computer. 

The serial number issued to you for this product indicates the highest version of Quickbooks Pro, Premiere or 
Enterprise that the product can be used with. If your registration code contains the year "03" at position 2 of the 
serial number, it is registered to only work with QuickBooks 2003 and lower versions. If the registration code is 
set to "04" it will work only with QuickBooks 2004 and lower versions and so on. 

You agree to affix a label to the archival copies, which contains the copyright notice printed on the original disk 
or tape from which the copy is made. LICENSER retains all rights to the Program not expressly granted in this 
agreement. 

OWNERSHIP OF PROGRAMS AND COPIES: This license is not a sale of the original Program or any copies 
thereof. LICENSER retains the ownership of the program and all copies of the Program, regardless of the form 
in which the copies may exist. The Program and accompanying manual(s) ("Documentation") are copyrighted 
works of authorship, and may contain valuable trade secrets and confidential information proprietary to 
LICENSER. The Program and the Documentation may not be copied, modified, or transferred without the 
express written permission of LICENSER. You agree to exercise reasonable efforts to protect LICENSER'S 
proprietary interest in the Program and Documentation and maintain them in strict confidence. 

USER RESTRICTIONS: You may physically transfer the Program from one computer to another provided that it 
is operated only on one computer. You may not electronically transfer such Program. Versions of this product 
not designated as "Web Version" may not be used in a web service, time-sharing or service bureau operation. 
You may not translate, modify, adapt, disassemble, de-compile, or reverse engineer the Program. You may not 
create derivative works based on such Program or Documentation or any portions thereof. 

TRANSFER: The Program is provided for use in your internal commercial business operations and must remain 
at all times upon premises owned or leased by you. You may not rent, lease, sublicense, sell, assign, pledge, 
transfer or otherwise dispose of the Program or the Documentation, on a temporary or permanent basis, without 
the prior written consent of LICENSER. 

TERMINATION: This license is effective until terminated. This license will terminate automatically without notice 
from LICENSER if you fail to comply with any provision of this license. Upon termination, you must cease all 
use of the program and return it, any copies thereof, including any archival copies, and the Documentation to 
LICENSER. 

GENERAL: This license shall be governed and construed in accordance with the laws of the State of California. 
In the event a provision of this Agreement shall be held unenforceable, it shall be deemed severable from the 
remaining provisions and shall in no way effect the validity or enforceability of the Agreement. The headings 
and captions used in this Agreement are for convenience only and are not to be considered in construing or 
interpreting this Agreement. 
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QODBC Limited Warranties and Limitation Of Liability 



LIMITED WARRANTY: LICENSER grants you as the original user of the Program a limited warranty that (i) the 
media on which the Program is distributed and the Documentation will be free of material defects for a period of 
NINETY (90) DAYS, and (ii) the Program will perform substantially in accordance with the material descriptions 
in the Documentation for a period of NINETY (90) DAYS. These limited warranties commence on the day you 
first obtain the Program and extend only to you, the original customer. Statements or representations which add 
to, extend or modify these warranties are unauthorized by LICENSER and should not be relied upon by you. 
These limited warranties give you specific legal rights, and you may have other rights which vary from state to 
state. 

DISCLAIMER: EXCEPT AS SPECIFIED ABOVE, LICENSER MAKES NO WARRANTIES OR 
REPRESENTATIONS, EXPRESS OR IMPLIED, ORAL OR WRITTEN, REGARDING THE PROGRAM, MEDIA 
OR DOCUMENTATION AND HEREBY EXPRESSLY DISCLAIMS ALL OTHER EXPRESS AND IMPLIED 
WARRANTIES, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE. LICENSER DOES NOT WARRANT THE PROGRAM WILL MEET YOUR 
REQUIREMENTS OR THAT ITS OPERATION WILL BE UNINTERRUPTED OR ERROR FREE. 

EXCLUSIVE REMEDY: Your sole and exclusive remedy in the event of a breach of the limited warranty set 
forth above is limited to either repair or replacement of the Program or the Documentation by LICENSER or 
refund of your money, at Licenser's sole discretion. To obtain warranty service, however, you must return the 
nonconforming item, with proof of the date you obtained it, to LICENSER no later than TEN (10) days after the 
expiration of the applicable limited warranty period. If LICENSER determines that the particular item has been 
damaged by accident, abuse, misuse or misapplication or has been modified without the written permission of 
LICENSER, or if any LICENSER label or serial number has been removed or defaced, the limited warranties set 
forth above do not apply and you accept full responsibility for the product. 

LIMITATION OF LIABILITY: LICENSER AND ALL PARTIES INVOLVED IN THE CREATION OR DELIVERY 
OF THE PROGRAM OR DOCUMENTATION TO YOU SHALL HAVE NO LIABILITY TO YOU OR ANY THIRD 
PARTY FOR SPECIAL, INCIDENTAL, INDIRECT, EXEMPLARY AND CONSEQUENTIAL DAMAGES 
(INCLUDING, BUT NOT LIMITED TO, LOSS OF PROFITS, GOODWILL OR SAVINGS, DOWNTIME, 
DAMAGE TO OR REPLACEMENT OF EQUIPMENT AND PROPERTY OR RECOVERY OR REPLACEMENT 
OF PROGRAMS OR DATA) ARISING FROM CLAIMS BASED IN WARRANTY, CONTRACT, TORT 
(INCLUDING NEGLIGENCE), STRICT TORT OR OTHERWISE, EVEN IF LICENSER HAS BEEN ADVISED 
OF THE POSSIBILITY OF SUCH CLAIM OF DAMAGE. LICENSER'S LIABILITY FOR DIRECT DAMAGES 
SHALL NOT EXCEED THE ACTUAL AMOUNT PAID FOR THE PRODUCT. 

EXCEPTIONS: Some countries and states do not allow the exclusion or limitation of implied warranties or 
liability for incidental or consequential damages, so the above limitations or exclusions may not apply to you. 
The conditions conferred by this warranty do not, however, overwrite any other rights and remedies in respect 
of the product which you have under applicable laws in your Country or State. 

US GOVERNMENT RESTRICTED RIGHTS: The Program and Documentation are provided with RESTRICTED 
RIGHTS. Use, duplication or disclosure by the US Government is subject to restriction as set forth in 
subdivision (c) (1) (ii) of the Rights in Technical Data and Computer Software Clause at 252.227-7013. 
Contractor/manufacturer is FLEXquarters, 6965 El Camino Real, Suite 105 #488 Carlsbad CA 92009 USA. 



QODBC 4 



Introduction 
What is ODBC? 



ODBC (Open Data Base Connectivity) is a specification designed by Microsoft to: 

1 . Allow Windows applications to access multiple data sources through a single method with no regard for 
various file formats; 

2. Overcome the problem of different databases having different means of providing access to the information 
contained within them and; 

3. Simplify access requirements so that the user no longer requires a high level of skill to access databases. 



ODBC also provides the following benefits: 



1 . SQL (Structured Query Language) is promoted as the method for accessing data through ODBC; 

2. It simplifies application development, making access to multiple databases easier; 

3. It insulates applications from changes to underlying network and database versions. Modifications to 
networking services, servers, and databases will not impact current ODBC applications; 

4. The Corporation's investment in the existing database is protected; 

5. The developer's acquired database programming skills are protected; 

6. Making this easily accessed data available to some users can increase productivity and is a basis for more 
informed decisions. 



Microsoft, along with a few other database manufacturers designed the ODBC driver to provide a standard, 
consistent and simple process of connecting a wide range of databases. 

Vendors of ODBC drivers (like this one) follow the specifications for ODBC so that any ODBC compliant 
application can access the data available through the driver. 

ODBC compliant applications include: Microsoft SQL Server, Microsoft Access, Word, Excel, PowerBuilder, 
Borland Delphi, Crystal Pro Report Writer, Visual Basic and hundreds of others. The placement of this driver 
can be seen in the illustration below. 



Application 



Driver Manager 


QODBC 
D river 


Driver 


D river 



4 — ODBC Interface 
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What is 0 ODBC? 



QODBC is an ODBC driver (DLL) for QuickBooks format files. QuickBooks by default stores its data in its own 
proprietary DBMS file format (.qbw). This driver allows users of any ODBC compliant front-end application to 
read and write data contained in QuickBooks format files similarly to any other ODBC enabled database. 

QODBC works by accepting SQL commands through the ODBC interface, then converting those calls to 
navigational commands to the QuickBooks DBMS and returning record sets that qualify for the query results. 

What can I do with 0 ODBC? 

QODBC opens up the QuickBooks files to a whole new world of database connectivity. In the same way that 
Windows has created an environment where all applications have a similar look and feel, ODBC drivers make 
all database formats look the same. 

• A user in Microsoft Office can use Excel to pull company accounting or invoice information directly into a 
spreadsheet and create a chart. 

• Microsoft Word can do a customer mail merge directly from QuickBooks files. 

• Crystal Pro Report writer can create multi-file reports from QuickBooks data. 

• Microsoft Access or Borland Delphi can be used to merge QuickBooks data with other data sources to 
produce complex reports, or to run mass file updates based on multiple criteria. 

Best of all, this driver is transparent and works in exactly the same fashion of ODBC drivers from other vendors. 
QuickBooks application developers now can offer this driver to their customers to allow them direct access to 
data important to them through custom third party applications. Business personnel who require up-to-the- 
minute data to make on the fly business decisions will have that real-time data instantly available to virtually 
hundreds of desktop applications. 
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Installation 



Initial Setup 

If you have downloaded this program by modem, run the self-extracting executable in a temporary directory to 
extract the installation files. Don't forget to read the "Readme" file during installation for the latest information 
on OODBC setup and other information. 

Unload Microsoft Office toolbar from memory, as well as any other Windows applications that can impair 
installation. Click on the Install program from within Windows to install the driver. Select the destination directory 
to install the QODBC support files. Click "OK" to continue. 



FLEXquarters QODBC Driver for QuickBooks Installation 




Select Destination Directory 



Please select the directory where FLEXquarters QODBC Driver 
for QuickBooks files are to be installed. 

"Free Disk Space After Install'" is based on your current 
selection of files to install. A negative number indicates that 
there is not enough disk space to install the application to the 
specified drive. 



C:V.AQ0DBC Driver for QuickBooks 




1 Current Free Disk Space: 


3311312 k 


| Free Disk Space After Install: 


3375631 k 



< Back 


! Next > 




Cancel 







The FLEXquarters QODBC Driver for QuickBooks® Pro has been successfully installed onto your computer. 
You can begin to use it immediately, because it will immediately run as a free QODBC Basic Edition, with read- 
only access to the QuickBooks list tables. 



ID 



Activate Pro Edition 
C++ Demo 

Configure QODBC Data Source 
Microsoft Query 
QODBC 2003 Manual 
QODBC 5etup Screen 
QODBC Test VBScript 
QuickBooks Table Schema 
README File 
Sample Data 
Uninstall QODBC 
VB Demo 



To install a full purchase or evaluation QODBC registration code, see the Icons 
that have been added to your Start Menu under QODBC Driver for 
QuickBooks® 

The first step in configuring the driver is to click on the ODBC Setup Screen icon 
and the following screen will be become available. 
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QODBC Setup Screen 



QFLEXquarters QODBC Ver 4.00.00.005 Setup \~ 










ODB 


OPEN 

ACCOUNTING 
SOLUTIONS 




OK J 

Cancel 
Messages 






Security 


Data Name: |llUIH!IAW!lIll=U=' 




Company File: |. 




Register j 


'*♦' Follow Company File 
f~ Multiuser Mode 
C Single User Mode 


Transfer 
About 



Data Name is a display name for your QuickBooks data (QuickBooks Data, QBPRO, My QB Data, etc.) 

Company File is the path where your QuickBooks data file resides. For example: "C:\Program 
Files\lntuit\QuickBooks Pro\Myapp.qbw". If you leave this settings "." (period) it will use the currently open QBW 
file. The browse button (...) will let you choose your QuickBooks company file from the folder it is in. 



• Open Style includes multiple ways of opening a QuickBooks file, and this setting allows you to 
determine how QODBC should open each company file. 

• Follow Company File If you select "Follow Company File", we will simply use whatever mode is 
currently set on the file. 

• Multiuser Mode Selecting "Multiuser Mode" will set the file to Multi-user status, where multiple users 
can update the file simultaneously 

• Single User Mode If you require exclusive write access to the file, select "Single User Mode." 

Messages Menu 



QFLEXquarters QODBC Ver 4.00.00.005 Messages 



Message Center 



Review QODBC Messages 



Clear QODBC Messages 



Review QB SDK Messages 



-Advanced Message Center 
f Display Driver Status 
Detail Tracing (Slow) 

Review Jrace Log 




Clear Trace Log 



Include Raw Files 



OK 



Cancel 



Message Center allows you to review messages from QODBC regarding errors and issues communicating with 
QuickBooks, Clear these messages, and review messages produced by the QuickBooks SDK interface. 



Advanced Message Center allows you to display a menu while the driver is running showing the current driver 
status (debug panel), create a detailed trace log, review and clear the trace log. 
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Include Raw Files if checked will display both the filtered and raw data files in table selections. 
Security Menu 



QFLEXquarters QODBC Ver 4.00.00.005 Security 



Activate QODBC Security (Not QuickBooks Login) 
User: | 
Password: | 



I - Display Login Box 



1 



OK 



Cancel 



User and Password allow you to set a default QODBC login name and password for this machine, if you have 
appropriate security for your computer, you may want the login name question to be automatically bypassed. 
Please read the data security chapter in the manual regarding this feature. This is a QODBC feature, and 
should not be confused with the login process for QuickBooks. 

Display Login Box will force the driver to request a login name and password each time it is started. This 
option is helpful for users of our Security features, to force the end users to be prompted to login, even if the 
application they are using does not have a login feature. 

Transfer Menu 



'FLEXquarters QODBC Ver 4.00.00.005 Transfer License 



The steps to transfer a license: 

1) Install unregistered software. 

2) Press 'Create Transfer Floppy' on unregistered computer. 

3) Next press 'Transfer License to Floppy' on registered 
computer. 

3) Finally press 'Transfer License from Floppy' on the 
unregistered computer 



Create Transfer Floppy 



I ransfer License to Floppy 



Transfer License from Floppy 



Cancel 



The transfer menu allows you to move a QODBC license from one machine to another. This should only be 
used after consulting with our support department. 
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Registration Screen 



IFLEXquarters QODBC Driver for QuickBooks® 




QODBC Driver for QuickBooks® 

QODBC Basic 2003 
Version 4.00.00.005 

Copyright© 1995-2003 FLEXquarters.com LLC. 

All rights reserved 

FLEXquarters.com LLC. 
6965 El Camino Real, Ste 105 #488, Carlsbad CA 92009 
Support: support@qodbc.com Web: www.qodbc.com 



Registration (Optional) 
Serial Number: 
Name: 

Request Code: 
Software ID: 
Registration Code 



□ K 




Serial Number, Name, Request Code, Software ID and Registration Code are entered from the values 
shown on the registration email you receive after purchasing the product. If you are evaluating the program in 
Basic mode, you do not need to enter any values in the registration screen 

Update Registration box should be checked if you are upgrading from one license code to another. 

Update Options button will allow you to see your local dealer information and link direct to our web site for 
product ordering and upgrade information. 



QODBC 10 



First use of 0 ODBC after setup is complete 



The first time you run this driver (for example, you can test it using the VB Demo program included), you need 
to be running QuickBooks Pro on the machine at the same time and logged in as Administrator. This is for 
security reasons. 

Click on the VB Demo icon to launch the demo. To establish a connection: From the menu bar select 
"Connection" / "Add a new connection ", select the QuickBooks Data Source you want, Click "OK". 



f\ VB Demo 32 



File 



Connections Options Fonts Help 



Current Connection: Quickbooks Data 1 * 



Tables Query Disconnect 



SELECT 1 FROM Customer 



Query Result: 



After you click "OK" a QODBC splash screen will pop up if you are using the Free QODBC Basic Edition of the 
product, and a mouse click will allow you to continue. No such splash screen appears in the registered version. 

When the driver starts, QuickBooks Pro will ask permission for the driver to access your QuickBooks data. 
Answer "Yes, Always" to this and the QODBC driver is added to the Integrated Application list. 

This will allow applications to integrate with QuickBooks data when QuickBooks Pro is running on the desktop. 
There may be instances in which you want an integrated application designed to share data with QuickBooks 
Pro to access QuickBooks files automatically, without user intervention. This might permit, for example, a 
particular application to run during the night when there is no other activity on the company file. Also 
QuickBooks Pro need not be running for ODBC compliant applications to access the data files while set in this 
mode. 



QODBC 11 



QuickBooks - Application with No Certificate 



0(> 



An application without a certificate is requesting access to the following 
QuickBooks company: 

Larry's Landscaping & Garden Supply 

- The Application Calls Itself - 
FLEXquarters QODBC 



■ Certificate Information 

This application does not have a certificate. QuickBooks 
cannot verify the developer's identity. 



QuickBooks Solutions Marketplace — 
Search for information about this application at the 
'/ QuickBooks Solutions Marketplace 



Do you want to let this application share data with your QuickBooks company file? 
Yes, This Time 



Yes, Always 



No 



Help 



Allowing an application to login automatically: 

From the QuickBooks Edit menu, select Preferences, and then select Integrated Applications. 



Preferences 



Accounting" 

Checking 
*lsls 



My Preferences 



Company Preferences 



OK 



Desktop 
View 

% 

Finance 
Charge 



General 

t 

Integrated 
Applications ■*■ | 



You can manage all applications that interact with this QuickBooks company file here. 

I Don't allow any applications to access this company file 

W Notify the user before running any application whose certificate has expired 

p Applications that have previously requested access to this company file — 

I Allow Access Application Name 



Cancel 



Help 



Default 



y 


FLEXquarters QODBC 


■ 





Properties. 



Remove 



Also See: 

General 

Service 
Connection 



To learn more about applications that integrate with QuickBooks, go to the 
i QuickBooks Solutions Marketplace 
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• Click the Company preferences tab and make sure that the "Don't allow any applications to access this 
company file" checkbox isn't checked. 

• The "Notify the user before running any applications whose certificate has expired" checkbox can be 
checked. If it is, however, automatic access will be suspended if the application's certificate expires. 

• Select the FLEXquarters QODBC driver you want to run automatically and click Properties. 

• Check "Allow this application to access this company file." 

• Uncheck "Prompt before Allowing Access." 

• Check "Allow this application to log in automatically." 

This procedure need only be done once for QODBC to be able to connect with the QuickBooks data from any 
other ODBC compliant application in the future. 

Additionally if you plan to modify the files, you will also need to choose "Multi-User Mode" from the 
Files menu in QuickBooks to allow this. 
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Testing Driver Capabilities 



This driver is not guaranteed to work with all possible front-end ODBC applications, and it would be impossible 
to test them all. If you find you have problems with this driver that do not occur in other ODBC drivers, contact 
support at FLEXquarters. We do want to provide maximum compatibility wherever possible. A simple Visual 
Basic test program called VBDEMO.EXE has been included in this product to allow basic testing and to isolate 
problems from various environments. 

VB Demo 

To establish a connection: From the menu bar select "Connection" / "Add a new connection ", select the Data 
Source you want, Click "OK", an established connection to your data source message appears, Click "OK", type 
in your SQL query, Click "Query" button and the requested query results will appear. Or Click on the table's 
button to see a list of the available tables. 



VB Demo 



File Edit Connections Options Fonts Help 



Current Connection: Quickbooks Data 1 ▼ 



Tables 



Query 



Disconnect 



SELECT 1 FROM Customer 



Query Result: 43 



Row 


BillAddressAddr: 


BillAddressAddr: 


BillAddressCity 


BillAddressState 


BillAddressP 


2 


1800 Appleseed 




Bayshore 


CA 


9432G 


3 


Edward 


431 Hampshire 


Bayshore 


CA 


9432G 


4 


429 Silverbell 




East Bayshore 


CA 


94327 


5 


431 Wyatt Ave 




East Bayshore 


CA 


98727 


G 


7521 W. Vista 




Middlefield 


CA 


98727 


7 


345 Cherry 




Middlefield 


CA 


94482 


8 


300 Main Street 




Bayshore 


CA 


9432G 


9 


101 Bayshore 




Bayshore 


CA 


9432G 


10 


109 N. Elm 




Middlefield 


CA 


94482 


11 


370 Easy Steet 




Middlefield 


CA 


94482 


12 


Dru Gregory 


529 Main St 


Bayshore 


CA 


9432G 


13 


459 Saxon Ave 




East Bayshore 


CA 


94327 


14 


7221 W. Sun 




Bayshore 


CA 


94482 


15 


95 Amber Street 




Bayshore 


CA 


9432G 


1G 


Cristina Jimenez 


421 Jasmine 


East Bayshore 


CA 


94327 



To disconnect, you can either select "connections" / "remove the connection" or Click the "disconnect" button. 
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Data Security 



If you have an application which stores sensitive company information, you may want the option to restrict 
which tables can be viewed by the users of the OODBC driver. OODBC includes a number of security options 
to allow you maximum flexibility and security. If you do not setup any security options, all files will be available 
to all system users. 

All security changes are made via the ODBC command interface, so you can setup security in the included 
VBDEMO application, or in Microsoft Access SQL entry window. The following SQL commands will instruct the 
driver on how security should be setup on your computer network, and a file called FQQB.SEC will be created 
in the same folder as your .qbw file. 

Note: Although the OODBC security file is set to "read only" mode by the driver, the possibility exists that users 
could delete the security file. You must ensure that the folder that is used for this file is set to not allow users to 
delete files; otherwise your security settings could be compromised. 

To force users to login to the driver, use the "Login" option in the OODBC system setup screen. 

There are two primary ways to setup the security rules used by OODBC: Grant all rights, and Revoke all 

rights. You need to decide which of these methods to start with, and it is usually based on how many tables 
you have that are critical to protect. If you have only want to restrict access to a few tables (such as a credit 
card table and a salary table), choose the Grant all rights method, then revoke the rights for the specific tables. 
If you want users to only have access to a few select files, which are related to their job, choose the Revoke all 
rights method, then grant rights to the specific tables you want them to be able to access. 

The term "users" can apply to a single person on your system, or it can apply to a class or group of employees. 
Any number of stations can use the same security rights you have assigned to a "user" of OODBC. Rights 
granted to the "Public" user are assigned to any user who does not login with a password to use the driver. 

Command format 

Add a user: 

sp_adduser 'username' 'password' 

Modify a user: 

sp_alteruser 'username' 'newpassword' 

Delete a user: 

sp_dropuser 'username' 

Grant security rights to a user: 

GRANT {ALL | rights list[,...n]} ON {ALL | tablename[,...n] | tablename(columnlist[,...n])[,...n]} TO 
{username[,...n] | Public} 

Revoke security rights from a user: 

REVOKE {ALL | rights list[,...n]} ON {ALL | tablename[,...n] | tablename(columnlist[,...n])[,...n]} FROM 
{username[,...nj | Public} 
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QL command rights that can be granted or revoked: 
ALTER TABLE 
CREATE INDEX 
DELETE 
DROP 
INSERT 
SELECT 
UPDATE 
GRANT 
REVOKE 
SP_REINDEX 
SP_ADDUSER 
SP_ALTERUSER 
SP_DROPUSER 

Entering commands 

Commands to change the security settings can be entered in the included VBDEMO application, or your SQL 
based application of choice. 



"ft VB Demo 32 



File 



Connections Options Fonts Help 



Current Connection: Quickbooks Data 1 



Xables Ifluery disconnect 



sp_adduser 'mark' "markpassword" 



Query Result: 



Enter the command in the SQL entry area and press enter. If the command was accepted, you should get a 
message similar to this: 



VB Demo 32 



Query Executed, No results returned 



OK 
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At this point, your security file has been created, and you can add additional commands. If you want to clear all 
security options and start over, delete the FQQB.SEC file. Security options become active the next time you 
load the driver. 

Grant all rights 

In this security option, you grant the ability to all system users to have access to all of the tables listed in your 
QuickBooks files. After doing this, you can selectively revoke the rights to individual files that you want to 
protect. 

Example Session 

Give all system users rights to read all files: 

GRANT all ON all TO Public 
Revoke rights to the EmpRecs table: 

REVOKE all ON EmpRecs FROM Public 

Now, everyone can use all tables except the EmpRecs table. Additional secure files can be processed at this 
point. 

Add a system user: 

sp_adduser 'Linda' 'lindapassword' 
Give the new system user all rights: 

GRANT all ON all TO Linda 

Now all users have access to all tables except for the EmpRecs table, but if Linda logs in, she will have access 
to all of the tables available, because she has been granted rights that the public group does not have. 

Revoke all rights 

In this security option, you revoke the access rights to all of the tables listed in your QuickBooks files. After 
doing this, you can selectively add rights to the individual files that you want users to have access to. 

Example Session 

Revoke all system users rights to use all files: 

REVOKE all ON all TO Public 
Grant rights to the OrdEntry table: 

GRANT all ON OrdEntry TO Public 
Now, the only table that everyone can use is OrdEntry. Additional public files can be processed at this point. 
Add a system user: 

sp_adduser 'Linda' 'lindapassword' 



QODBC 17 



Give the new system user all rights: 

GRANT all ON all TO Linda 

Now all users have access to the tables they have specifically been granted, but if Linda logs in, she will have 
access to all of the tables available, because she has been granted rights that the public group does not have. 

Other Examples 

Allow read-only access to all users: 

REVOKE all ON all TO Public 
GRANT select ON all TO Public 

Delete a system user & associated rights: 

sp_dropuser 'Linda' 
Grant multiple rights: 

GRANT insert, delete, update ON all TO Brad 
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QODBC Errors 



There are many different types of errors returned by ODBC. The most common of which is the generic "Syntax 
Error". This typically means that your SQL query could not be parsed, possibly because of one of the following 
types of errors. 

• Reserved words used as a field name or file name. 

Check the list at the end of this document for possible conflicts. 
Embed names of fields and files in double quotes. 

• Wrong type of quote characters used. 

Single quotes (') are used around data values of a non-numeric type. Double quotes (") are used around file 
and field names. 

• Only 101 records shown in MS Access. 

When a table is called up, MS Access will only display the first 101 records. To see all records in the table, 
select a column that is an indexed field, and use the sort a-z icon. 



There may be other syntax related errors we are not yet aware of. Syntax errors are always an SQL related 
problem, not a problem with the QuickBooks file system. If you manipulate files directly via SQL, you may want 
to purchase a book on SQL to use with this product. This manual does not provide adequate reference to SQL 
syntax 

Tracing 

A tracing mode has been included in the product. It allows you to trace all ODBC calls made to the driver for 
debugging purposes. Our support staff may require a trace log if your application returns an unexpected error. 

To trace operations, simply click on the messages button in the setup panel and check Detail Tracing. 
Tracing will be sent to an ASCII file called QODBCTRA.TXT in the QODBC installation directory. 
The trace includes all ODBC calls made and related errors returned by the driver. If you cannot see the 
problem, e-mail it to us for review. 

Note: If you opt to use this feature make sure it is turned off once you have viewed the log. If left on, 
this file will keep getting larger and take up valuable disk space 
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QODBC Tutorials 



Microsoft Office 2000 



Before using any Microsoft Office 2000 applications, you must ensure that the Microsoft Query builder is 
installed. 

Double Click on the Microsoft Office 2000 Setup, Click to update the installation, check the options to select the 
items you want installed and uncheck the options to clear the items you do not want installed, be sure to check 
the "Microsoft Query" option. 




SETUP 

Maintenance Mode 
Selecting Features 

Installing Office 



a 




El 




El 




□ 






El--- 



Microsoft PowerPoint for Windows 
Microsoft Outlook for Windows 
Microsoft Access for Windows 
Office Tools 



+ 



Clip Gallery 







Digital Signature for VBA projects 






Equation Editor 


El 


0-J' 


HTML Source Editing 


El 


i' 


International Support 




0-J' 


Language Settings Tool 


II 


X ' 


Microsoft Binder 


El 


_J' 


Microsoft Graph 






Microsoft Office Shortcut Bar 




X - 


Microsoft Photo Editor 






iMicrosoft Query i 



Office Assistant 



Description: 

Provides direct database connectivity to analyze data in Excel, 



# Microsoft Office 2000: Update Features 


[X] 







13 



Size: Selected Features; 1280KB 



Free Disk Space: 20GB 



Help 



Cancel 



<< Back 



Update Now 



Selecting Microsoft Query 

Click "Update Now" to install the components. 
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MS Query 2000 



(Make sure you have QuickBooks and the Company file open "minimized" that you want to query) 



This is a utility worth having a desktop shortcut to, especially for those who are not very familiar with creating 
SQL statements. The MS Query executable can be launched from the following directory: 
C:\Program FilesWIicrosoft Office\Office\MSQRY32.EXE 



i Microsoft Query 



File Help 



t£] & u 



SQL 



Ready 



NUM 



Select the option File / New, and you will see the following screen. 



Choose Data Source 



Databases j Queries | 



dBASE Files" 
DF Samples 11 
Excel Files" 
MS Access Database" 
Quickbooks Data 
Quickbooks Data" 
Quickbooks Data" 
Quickbooks Sample" 
Quickbooks Sample" 



OK 



Cancel 



Browse.. 



Options.. 



Delete 



I - Use the Query Wizard to create/edit queries 



Highlight the data source you wish to use and click "OK". The data source selected here is the Sample Serviced 
Based Business, which is currently opened. (Uncheck the Query Wizard if checked, to create more in depth 
queries) 
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The Add Tables screen will then pop up, highlight the table you wish to query and the click "Add" and then 
"Close". 



Add Tables 



Table: 



ChargeCredit 
Check 
Class 
Company 
CreditCardCharge 
CreditCardCredit 
CreditM emo 
Customer 
CustomerMsg 



Owner: 
Database: 



13 

□ 



0 



? X 



Add 



Close 



Options.. 



"3 
"3 



MS Query should now show the table selected and with a scrollable list of all the fields available. If you double 
click on the asterisk in the list of fields available, it will populate the table with all of the available fields and 
records of that table or select only the fields you are interested in. 



i Microsoft Query - [Query from Quickbooks Data] 



- n [xj 



File Edit View Format Table Criteria Records Window Help 



3 X 



^ & y 



SQL 



Customer 


: x \ 


A 


AccountNumbf 




AltContact 




AltPhone 




Balance 




BillAddressAdd 


V 



Name 



FullName 



ParentRefListlD Parent Ref FullName 



Co ^ 



Russell Chiropractic 
Sage, Robert 



Sonnenschein, Russ 
Stins on, Tracy 
Theurer-Davis, Vicki 



Tumacder, Jacint 
Walker, Rich 
Williams, Abraham 



Russell Chiropractic 
Sage, Robert 



Sonnenschein, Russ 
Stinson, Tracy 



Theurer-Davis, Vicki 
Tumacder, Jacint 
Walker, Rich 
Williams, Abraham 



Wood's Garden Cafe Wood's Garden Cafe 



Russe 



Abe's 
Wood 



N 4 Record: 43 



► M 



Select View Criteria to show/edit criteria limiting records showi 



INUM 



A total of 43 records are returned from the table in grid view, with no criteria applied to underlying SQL 
statement. (Select * From Customer) 
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To apply criteria to the underlying SQL statement (Select * from Customer) click "Criteria / Add Criteria" 



Add Criteria 



And T Or 



Total: 



|BillAddressPostalCode 






| equals 





Value: 1 94482 



[Xj 



Add 



Close 



Values... 



The Add Criteria panel will allow you to select the available fields from the query from a dropdown selection 
menu along with an operator and the associated values for that field. The above selection will generate an 
underlying SQL statement equivalent to: 

Select* From Customer Where (Customer.BillAddressPostalCode='94482') 



i Microsoft Query - [Query from Quick books Data] 



Fj| e Edit View Format Table Criteria Records Window Help 



^ & y 



SQL 



3 x 



Customer 


: x \ 


A 


AccountNumbf 




AltContact 




AltPhone 




Balance 




BillAddressAdd 


V 



Criteria Field 
Value 
or 



Bill^ddressPostalCo 



'94482' 
< 



M 



Name 



FullName 



ParentRefListID ParentRef FullName 



Co - 



Leon. Richard 
McCale, Ron 



Leon. Richard 
McCale, Ron 



Middlefield Elementary S Middlefield Elementary S 



Rick's 



| Recor d: 7 
Ready 



■r 



|NUM 



The returned recordset contains 7 records meeting the applied criteria as shown above. Click on File / Exit 
"Save Changes / No" to exit MS Query. 
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MS Access 2000 

Creating a Table in Microsoft Access 

Microsoft Access is a product with many uses, and will allow you to use your QuickBooks data files in the same 
fashion as Access databases. 

Selecting the option File / New, you should see the following screen: 



Microsoft Access 



Create a new database using 



(* glank Access database! 

f Access database wizards, pages, and projects 



6 



f Open an existing file 



C:\Access Databases\Cogitate Cust 


0 


C:\Access Databases\dbl 


Northwind Sample Database 




Contacts Sample Database 




Address Sample Database 





OK 



Cancel 



Select Blank Access Database and click "OK" 
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A default database filename db1 appears in the box. You can edit this to a more relevant name, such as QB 
Link.mdb. Save the file as type: "Microsoft Access Databases". Click on "Create". 
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Microsoft Access 



File Edit View Insert Tools Window Help 



m 



iJ <lb1 : Database 



Open Design ^New I X I | £:[: 




£3 Favorites 



IflJ jCreate table in Design view! 
Create table by using wizard 
Create table by entering data 



Ready 



NUM 



A 



Microsoft Access Blank Database 



Click the "New" button. 



New \ 



able 



? X 




This wizard creates tables in 
the current database that are 
linked to tables in an external 
Pile. 



Datasheet View 
Design View 
Table Wizard 
Import Table 
Link Table 



OK 



Cancel 



Microsoft Access New Table 



Select "Link Table" click "OK". 
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Link 



Look in: 




Q Temp 



& iXgl' Tools 



File name: 
Files of type: 



Microsoft Access 



3] 



& Link 



Cancel 



Microsoft Access Link Table 

Change the "Files of Type" list to the setting for "ODBC Databases". 



Select Data Source 



File Data Source Machine Data Source 



Look in: (Data Sources 



C5bar.aFlexData32 
SDataFlexTest32 
QuickbooksData 



D S N N arme: Q uickbooks D ata 



"3 ej 



New... 



Select the file data source that describes the driver that you wish to connect to. 
You can use any file data source that refers to an ODBC driver which is installed 
on your machine. 



□ K 



Cancel 



Help 



Microsoft Access ODBC Dialog 
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Select the QuickBooks related DSN you setup with the QODBC driver. This can be one of our pre-installed DSN 
names or one that you have created. 



Link Tables 



? X 



Tables ] 



Account 
Bill 

Charge 

ChargeCredit 

Check 

Class 

Company 

CreditCardCharge 

CreditCardCredit 

CreditMerno 

Customer 

CustomerMsg 



OK 



Cancel 



Select All 



Deselect All 



I - 5ave password 



Microsoft Access Link Tables List 

Select one or more QuickBooks tables to add to your Microsoft Access project and click "OK" 



Microsoft Access 



□ x; 



File Edit View Insert Tools Window Help 




jOpen |^ Design ^jNew -a IV H: 



Objects 



IS 5 Queries 

BE Forms 

l" Reports 

'il Pages 



ules 



2 

| | 



Groups 





iCreate table in Design view! 




CreditMerno 




Create table by using wizard 


+ f 


Customer 


CI 


Create table by entering data 


+ f 


CustomerMsg 


♦® 


Account 


*m 


CustomerOtherAddresses 


+ f 


Bill 


♦ f 


CustomerType 


+ # 


Charge 


♦ r 


DateDrivenTerms 




ChargeCredit 


♦® 


Employee 


+® 


Check 




Estimate 




Class 


+® 


Host 


+® 


Company 


+ V 


Invoice 




CreditCardCharge 


♦ # 


ItemDiscount 


+ # 


CreditCardCredit 




ItemGroup 


TT i l> 



Ready 



NUM 



Microsoft Access Database 
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Your QuickBooks tables are now part of your Microsoft Access project as externally linked tables. This does not 
mean the data in these tables has been imported into Access, but rather that Access will open and work with 
the live QuickBooks data files, using OODBC to communicate with them. Click on one of the table names to 
bring up the data grid view. 



f 

^Microsoft Access - [Customer : Table] 


□ P 


j 11 File 


Edit View Insert Format Records Tools Window Help 






y # a ^ & ^ ls £Ui|^ir « ►* * 






BillAddressAdt 


BillAddressAdi 


BillAddressAdi 


BillAddressCitj 


BillAddressSta 


BillAddress 






Kristy Abercrorr 


5647 Cypress h 




Bayshore 


CA 


94326 






Bak 
Mike 


er, Chris 


415 W. Desert ! 




Bayshore 


CA 


94326 




3 Balak 


8753 S. Mounta 




Bayshore 


CA 


94326 




Renee Barley 


4417 N. Sun Va 




Middlefield 


CA 


94471 




Rafal Bolinski 


1421 Silverbell; 




East Bayshore 


CA 


94327 




Son 


ya Bristol 


5920 N. Lightho 




Bayshore 


CA 


94326 




Jason Burch 


5960 N. Wet mo 




Bayshore 


CA 


94326 




Burney , Tony 


910 S. Ivy 




Bayshore 


CA 


94326 




Brian K. Cook 


345 Cherry Lant 




Middlefield 


CA 


94482 




Ram Craven 


7105 N. Landon 




E. Bayshore 


CA 


94327 




Matthew Cuddir 


8321 S. Flower 


E. Bayshore 


CA 


94781 




Duncan, Dave 


3442 W. Charle 


Bayshore 


CA 


94326 




Dunn, Eric C.W 


97401 N. Libert* 


Bayshore 


CA 


94326 




Paula Easley 


140 Bay View 




East Bayshore 


CA 


94327 




Deanna Ecker 


95 Amber St 




Bayshore 


CA 


94326 




Jennifer Fisher 


7882 N. Lantan; 




E. Bayshore 


CA 


94326 




Slava Fornin 


3366 E. Maple 




Bayshore 


CA 


94326 




Kirov Freeman 


6856 Ocean Vie 




Bavshore 


CA 


94326 


Record: 


H | | i ► | H 


► #| of 47 < 


J _iJ 


jDatasheet View 


NUM 







Microsoft Access Data Grid 



In this grid you can modify records, delete records and add new records to your QuickBooks table per the 
table/field accessibility of the QuickBooks 2004 schema. You can also build entry forms and queries now 
that your QuickBooks files are connected live to your Microsoft Access applications. 

Note: In the case where you run across an application which is not fully ODBC compatible, often times they do 
support getting data from Access tables. To make this application work with QuickBooks tables, you can run the 
Microsoft Access setup as shown above. Then have this application use the MS Access ODBC driver to talk to 
the Access database, which you created, which was linked to QuickBooks tables. This middleware approach 
allows us to support nearly any application, even if not fully ODBC compliant. 
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Microsoft Word 2000 

QODBC allows you to easily merge QuickBooks data onto your Word documents either as tables or as mail- 
merged fields. 

Open the Document you wish to mail merge QuickBooks data into, From the Tools menu select "Mail merge" 
and Click "Main Document - Create - Form Letters - Active Window" buttons. 



Mail Merge Helper 




The next step in setting up the mail merge is to specify a data source. 
Choose the Get Data button. 




Main document 



Create " | Edit T 

Merge type: Form Letters 

Main document: C:\...\QODBC Info Request.doc 




Get Data T 




Merge the data with the document 



J 



Cancel 

Mail Merge Helper 

Click "Data Source - Get Data - Open Data Source". 
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Open Data Source 



Look in: 



fr°> My Documents 




C^DMK Data Files 
£)My albums 
£^)My eBooks 
j^My Music 
jj^My Pictures 
LjJMy Received Files 
3 My Videos 
1]~$DBC Info Request 
fPjQODBC Info Request 



File name: 



Files of type: 



& iXgl* Tools 



All Word Documents 



MS Query. 



Select method 



& Open 



Cancel 



Open Data Source 

Click the "MS Query" button. MS Query will launch and the following screen will be seen: 



Choose Data Source 



Databases | Queries j 



dBASE Files" 
DF Samples 11 
Excel Files" 
MS Access Database" 
Quickbooks Data 
Quickbooks Data" 
Quickbooks Data" 
Quickbooks Sample" 
Quickbooks Sample" 



I - Use the Query Wizard to create/edit queries 



OK 



Cancel 



Browse.. 



Options.. 



Delete 



MS Query Choose Data Source 

Choose the Data Source Name (DSN) that is setup with your QuickFJooks data. It can be the default 
(QuickFJooks Data), which was setup by the installer or any DSN you have created. 
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Query Wizard - Choose Columns 



Hi 



What columns of data do you want to include in your query? 



Available tables and columns: 



Columns in your query: 



ParentFlefFullName 
Company Name 
Salutation 
iMiddleNamej 
LastNarne 
Suffix 

RillArirlrfissAHHr^l 
Preview of data in selected column: 



"0 

(ZD 



« 



BillAddresaAddrl 

BillAddressAddr2 

BillAddressCity 

BillAddressState 

BillAddressPostalCode 

FirstName 



Preview Now 



Options... 



< Back 



Next > 



Cancel 



MS Query Wizard Choose Columns 

Select the table that has the data you wish to merge into your document, and use the ">" button to select 
columns to include in the document. Pressing ">" on the table name will include all columns in the document. 
There are several screens allowing you to filter certain records, and to sort the records, followed by the final 
dialog. 



Query Wizard - Finish 



What would you like to do next? 

(* Return Data to Micro: oft Word 

C View data or edit query in Microsoft Query 



Save Query.. 



< Back 



Finish 



Cancel 



Select the Finish button to return the data to Microsoft Word. You will note a toolbar has appeared on the top of 
the document. 
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© QODBC Info Request - Microsoft Word 


(°Jl 


X 


File Edit View Insert Format Tools Table Window Help 




Normal 


B S 




» 


Insert Merge Field * Insert Word Field - V? H < 1 




Ek' %m Merge.,. 


» 


FLEXauarters 

Ynur 1 p i S ;i. : ■ Fur h N: m ill If: Nnflwriir: SnhiliivriN! 

USA Sales • 1700 Point Drive • Commerce, Ml • 48382 USA ph. 800-932-0448 

September 14, 2002 

Dear 

i nariK you Tor your i mto r m ai i o n requesi regarding our laiesi 
product, QODBC for QuickBooks 2002 Pro and Premier. Enclosed 
you will find QODBC product information and pricing. If you need 
additional information or have any questions regarding the product, 
please feel free to contact me. 

Regards, 
Mark Kuznar 


± 


l=Wfi]=l<l 1 


► 




[Page 1 5ec 1 1/1 | At 4,1" Ln 18 Col 1 


[trF 


EXT OVR 


m 


/, 



Microsoft Word with Mail Merge toolbar 



You can now click the "Insert Merge Field" button and choose the columns to include in this document one at a 
time. The fields will be placed at your current position in the document. 
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r 

©QODBC Info Request - Microsoft Word 




□ X 


File Edit View Insert Format Tools Table Window Help 




Normal <« 


B 








Insert Merge Field * Insert Word Field - %g \i 4 1 ► H 




^ !+! Merge... 


» 


FLEXauarters 

Yivur |-*i"-.i-:li|i.,irii"-rK Fur 1 hixilih: SnrlwHir: Sululirinxf 

USA Sales • 1706 Point Drive • Commerce, Ml • 43382 USA ph, 800-932-6448 

September 14, 2002 

«BillAddressAddr1» 
«BillAddressAddr2» 

«BillAddressCity» , «BillAddressState» «BillAddressPostalCode» 
Dear «FirstName», 

Thank you for your information request regarding our latest 
product, QODBC for QuickBooks 2002 Pro and Premier. Enclosed 
you will find QODBC product information and pricing. If you need 
additional information or have any questions regarding the product, 
please feel free to contact me. 

Regards, 
Mark Kuznar 


± 


■i»ra*i<i. i >\ 




| Page 1 5ec 1 1/1 At 3.1" Ln 12 Col 18 




TRK 


EXT OVR 


m 





Placing Merge fields in document 



When all of the columns are correctly placed in the document and any additional punctuation/inserts have been 
made, click the "« ABC »" button on the toolbar to see the merged data. 
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©QODBC Info Request - Microsoft Word [_ ][□]( 


X 


File Edit View Insert Format Tools Table Window Help 




Normal 


B — 


» 


Insert Merge Field * Insert Word Field - M < 1 ► M 




ik' !+! Merge.,. 


» 


FLEXquarters 

Yrjpur rEr>^di|iEAr1nrN Fin h l<i: will Ice SnPtwnrE SrtkMirinK! 

USA Sales • 1706 Point Drive • Commerce, Ml • 43332 USA ph. 800-932-644S 

September 14, 2002 

Kristy Abercrombie 
5647 Cypress Hill Rd 
Bayshore, CA 94326 

Dear Kristy, 

Thank you for your information request regarding our latest 
product, QODBC for QuickBooks 2002 Pro and Premier. Enclosed 
you will find QODBC product information and pricing. If you need 
additional information or have any questions regarding the product, 
please feel free to contact me. 

Regards, 
Mark Kuznar 

I 


± 






[Page 1 5ec 1 1/1 | At 4,5" Ln 21 Col 1 




TRK 


EXT OVR 







The left and right controls can be used to preview the data inside the document window. If you refer back to 
Access grid, you will note that this is the first record of 47 in this mail merge from the selected "Customer" table. 
Click the "Merge" button to create the output. 
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Merge to: 
[Printer 



Setup. 



Records to be merged 
(? Ajl r From: f 



10= r 



When merging records 
(* Don't print blank lines when data fields are empty, 
" Print blank lines when data fields are empty, 



Query options have been set 



Merge 
Close 



Check Errors, , 



Query Options, 



Output the Merge 

Clicking "Merge" will create the printed document, one customized for each matching record in your QuickBooks 
data file. You can also merge to a new document and edit the result. 

Note: If you cannot locate the MS Query button on the Mail merge Helper, run the MS Word (or the MS Office) 
Setup Program and install MS Query. 
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Microsoft Excel 2000 



QODBC allows you to quickly merge live QuickBooks data into the cells of your Microsoft Excel worksheets for 
quick calculations and graphs. The data will retain a live link to QuickBooks, and one click will update the data 
in the worksheet to the most current data in the linked QuickBooks table. 



Before using Microsoft Excel, you must ensure that the Microsoft Query Add-on is installed. See the Microsoft 
Office 2000 topic. 



I Microsoft Excel - Bookl 



File Edit View Insert Format Tools Data Window Help 



2 A li 



(3 " 



Arial 



_ B X 



A1 





A 


B 


C 


D 


E 


F 


G 


H 


I " 


1 




















2 




















3 




















4 




















5 




















6 




















7 




















8 




















9 




















10 




















11 




















12 




















13 




















14 




















15 




















16 




















17 




















18 




















1d 





















H \i I ► I HK Sheet 1 /~5h~eet2 / Sheet3~7 



Ready 



NUM 



Create a new worksheet in Microsoft Excel. 
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Select the menu "Data / Get External Data / New Database Query". The following Data Source screen is 
available: 



Choose Data Source 



Databases | Queries ] OLAP Cubes j 



dBASE Files" 
DF Samples 11 
Excel Files" 
MS Access Database" 
Quickbooks Data 
Quickbooks Data" 

Quickbooks Data" 

Quickbooks Sample" 
Quickbooks Sample" 



W Use the Query Wizard to create/edit queries 



3S 



OK 



Cancel 



Browse.. 



Delete 



Choose Data Source 

Select the Data Source that is currently opened in QuickFJooks and click "OK". 



Options... 



What columns of data do you want to include in your query? 



Available tables and columns: 

SalesRepRefFullName [a] 
; S alesT axCodeR ef Listi D ; 

: : 

S alesT axCodeFl efFullN anne 
ItemSalesTaxRefListlD 
I tennS alesT axR ef FulIN anne 
ResaleN umber 
AnnnuntNumher 

Preview of data in selected column: 



Columns in your query: 



« 



Name 

CompanyName 

CustomerTypeRefFullName 

Balance 

TotalBalance 



T|| Preview Now | Options... 



s 



< Back 



Next > 



Cancel 



Choose Columns 

Choose the table you wish to import, and select the columns from the table to import by pressing the ">" button. 
The next screens allow you to filter and sort the data to be imported, and then you will reach the finish screen. 
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Query Wizard - Finish 



What would you like to do next? 

Return Data to Microsoft Excel 
(• j^iew data or edit query in Microsoft Query 
C Create an OLAP Cube from this query 



Save Query.. 



< Back 



Finish 



Cancel 



Query Wizard Finish 



You can return the data to Excel at this point or as in the above screen, opt to edit the data in MS query and 
apply additional criteria to the QuickBooks recordset. Click "Finish". 



The desired recordset is to contain only the records with a "Customer Type" having a value equaling 
"Commercial". Select the field header name and click on it, it will then highlight the entire column. Next select 
"Criteria / Add Criteria", from the list of values (Residential, Commercial) select "Commercial" /Add. 

The following screen reflects the applied criteria to the query and the resulting QuickBooks recordset: 
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i Microsoft Query - [Query from Qirkkbooks Data] 



. □ 



File Edit View Format Table Criteria Records Window Help 



3 X 



& y JJ# SQL 



Customer 



AccountNumbf^ 
AltContact 
AltPhone 
Balance 

BillAddressAdd|v 



Criteria Field: 
Value: 

or: 



CustomerTy peR ef FulIN arne 








|a] 


'Commercial' 


















e 


< |„„ 


s 



Name 



CompanyName | CustomerTypeRef FulIN an| Balance | TotalBalance 



Ecker Designs 
Lew Plumbing - C 
Melton, Johnny 



Nelson, Wilma 
Pretell Real Estate 
Reyes Properties - C 
Robson, Darci 
Smallson, Fran 
Smith, Lee 



Ecker Designs 
Lew Plumbing 
Floss 'N Go Dental Care 
Nelson Printing 



M 



4 Record: 9 



VJm] 



Smallson Electric 
Smith Photography 

ijj 



Commercial 
Commercial 
Commercial 
Commercial 
Commercial 
Commercial 
Commercial 
Commercial 
Commercial 



.00 



7694.41 



175.00 



.00 



175.00 



.00 



.00 



.00 



4999.50 
.00 

29850.86 



.00 



,00 



.00 



.00 

12420.98 
1665.00 



.00 



Select File Return Data to Microsoft Excel to return data to client applicatior 



|NUM |SCRL 



MS Query 

Select File / Return Data to Microsoft Excel, the following screen will prompt you for the destination of the data: 



- 

Returning External Data to Microsoft Excel 


f 




Where do you want to put the data? 
(* Existing worksheet: 


OK 
Cancel 








C New worksheet 
C PjvotTable report 


Properties.,. 
Parameters.,, 





Click "OK" and the data will be populated into the existing Excel worksheet. 
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lH Microsoft Excel - Bookl ___ [ 


□ X 




File Edit View Insert F 

& Q B |S Gk 5 


-orrnat Tools Data Window Help _ B X 


JD 




» 


A1 




A 


Ei 


C 


D 


E 




1 


N di in p- 
■I ii 1 1 1 ? 


Cfi 111 11 j1 11 vN dl 111 

1 .- ■ r 1 1 1 |. r ■* 1 1 1 JT I14IIIIC 


Custom erTypeRe Balance TotalBalance 


2 


Frkpr Hip^irin^ 


Frkpr np^inn^ 

i ■_- n. <z? 1 [_• <z? -Z' i y i i ■_" 


Commercial 0 


7694.41 




3 


1 pwy Pli iiTihiriri - n 

1 CVV 1 1 '_l 1 1 1 1 1 1 L-j ■_■ 


1 pw Ph irnhinn 

1 G VV 1 1 '_) 1 1 1 1_> 1 1 1 L-| 


P 1 n in Y~f\ p vr i a 1 


1 r ■_' 


175 




4 


Mpltnn .Inhnnv 

1 i 1 1- 1 L 1 1 | 1 1 1 1 1 1 1 1 1 1 V 


Fln*?<s 'N Rn Dental Carp 


P n m iti p fn p 1 


n 


4999.5 




5 


Nplcnn Wilms 

IMCIOUI 1 | Y V III 1 la 


Nplcnn Print inn 

1 HCIOUI 1 1 IIIILIIIL4 
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Data Import Result 



The data from your QuickBooks table is now included in your worksheet and the data remains connected to the 
QuickBooks table from which it was imported 
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Clicking Data / Refresh Data will update the data in the worksheet from the latest information in the linked 
QuickBooks tables as shown above. Changes made to the QuickBooks files will not affect this worksheet until 
you refresh the data with the "Refresh" option. 
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ODBC SQL Reserved Words 



The following words are reserved for use in ODBC function calls. To ensure compatibility with drivers that 
support the core SQL grammar, applications should avoid using any of these keywords. 

Additional information on ODBC may be found on the Internet as follows: 

Microsoft: http://www.microsoft.com/ 



ABSOLUTE 


ADA 


ADD 


ALL 


ALLOCATE 


ALTER 


AND 


ANY 


ARE 


AS 


ASC 


ASS 


AT 


AUTHORIZATION 


AVG 


BEGIN 


BETWEEN 


BIT 


BITLENGTH 


BY 


CASCADE 


CASCADED 


CASE 


CAST 


CATALOG 


CHAR 


CHARLENGTH 


CHARACTER 


CHARACTERJ.EN 


CHECK 


CLOSE 


COALESCE 


COBOL ' 


COLLATE 


COLLATION 


COLUMN 


COMMIT 


CONNECT 


CONNECTION 


CONSTRAINT 


CONSTRAINTS 


CONTINUE 


CONVERT 


CORRESPONDIN 


COUNT 


CREATE 


CURRENT 


CURR 


CURRENTTIME 


CURRENTTIMEST 


CURSOR 


DATE 


DAY 


DEALLOCATE 


DEC 


DECIMAL 


DECLARE 


DEFERRABLE 


DEFERRED 


DELETE 


DESC 


DESCRIBE 


DESCRIPTOR 


DIAGNOSTICS 


DICTIONARY 


DISCONNECT 


DISPLACEMENT 


DISTINCT 


DOMAIN 


DOUBLE 


DROP 


ELSE 


END 


END-EXEC 


ESCAPE 


EXCEPT 


EXCEPTION 


EXEC 


EXECUTE 


EXISTS 


EXTERNAL 


EXTRACT 


FALSE 


FETCH 


FIRST 


FLOAT 


FOR 


FOREIGN 


FORTRAN 


FOUND 


FROM 


FULL 


GET 


GLOBAL 


GO 


GOTO 


GRANT 


GROUP 


HAVING 


HOUR 


IDENTITY 


IGNORE 


IMMEDIATE 


IN 


INCLUDE 


INDEX 


INDICATOR 


INITIALLY 


INNER 


INPUT 


INSENSITIVE 


INSERT 


INTEGER 


INTERSECT 


INTERVAL 


INTO 


IS 


ISOLATION 


JOIN 


KEY 


LANGUAGE 


LAST 


LEFT 


LEVEL 


LIKE 


LOCAL 


LOWER 


MATCH 


MAX 


MIN 


MINUTE 


MODULE 


MONTH 


MUMPS 


NAMES 


NATIONAL 


NCHAR 


NEXT 


NONE 


NOT 


NULL 


NULLIF 


NUMERIC 


OCTET LENGTH 
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OF 


OFF 


ON 


ONLY 


OPEN 


OPTION 


OR 


ORDER 


OUTER 


OUTPUT 


OVERLAPS 


PARTIAL 


PASCAL 


PLI 


POSITION 


PRECISION 


PREPARE 


PRESERVE 


PRIMARY 


PRIOR 


PRIVILEGES 


PROCEDURE 


PUBLIC 


RESTRICT 


REVOKE 


RIGHT 


ROLLBACK 


ROWS 


SCHEMA 


SCROLL 


SECOND 


SECTION 


SELECT 


SEQUENCE 


SET 


SIZE 


SMALLINT 


SOME 


SQL 


SQLCA 


SQLCODE 


SQLERROR 


SQLSTATE 


SQLWARNING 


SUBSTRING 


SUM 


SYSTEM 


TABLE 


TEMPORARY 


THEN 


TIME 


TIMESTAMP 


TIMEZONEHOUR 


TIMEZONEMINUT 


TO 


TRANSACTION 


TRANSLATE 


TRANSLATION 


TRUE 


UNION 


UNIQUE 


UNKNOWN 


UPDATE 


UPPER 


USAGE 


USER 


USING 


VALUE 


VALUES 


VARCHAR 


VARYING 


VIEW 


WHEN 


WHENEVER 


WHERE 


WITH 


WORK 


YEAR 







QODBC 44 



General Introduction to SQL 



The Structured Query Language ( SQL ) is an user interface for the storage and retrieval of information in a 
relational database. Using SQL, you can create, destroy or modify tables. Most importantly, though, you can 
query the information stored in tables. ODBC reserved words are shown in the "ODBC SQL Reserved Words" 
listing and may not be used as the name of a table, one if its columns or for anything else. 

Although SQL was developed by IBM, other vendors of relational database systems quickly offered SQL on 
their products, each version differing from the others in someway. The International Organization for 
Standardization has developed an internationally recognized SQL standard. If some of the examples in this 
book do not work with your system, check your local documentation. 

The Structure of SQL statements 

SQL (Structured Query Language) is a relational database language. SQL is not only used for storing and 
retrieving information or for access to data files but also for creating or deleting tables and for adding, altering or 
deleting records in these tables. The relational terms row and column are equivalent to the database terms 
record and field respectively. 

To allow access to the information in a database, SQL defines the reserved words (operations, functions and 
commands) of the language, which indicates the actions to be performed on the database. The entire SQL 
statement has its own specific syntax as described in the "definitions of some commonly used SQL/ODBC 
commands" section. The best way to learn SQL is first to use the examples based on the sample databases 
included in this program, and then to try similar statements on your own database. Once you have mastered 
these simple examples, try out some of the more adventurous examples. These can all be found at the end of 
this tutorial. 

SQL provides both the Data Definition Language (DDL) and the Data Manipulation Language (DML) 
commands. The DDL commands allow you to create and define new databases, fields and indexes while the 
DML commands let you build queries to sort, filter and extract data from the database. 



DDL Commands 

• CREATE is used to create new tables, fields and indexes. 

• DROP is used to delete tables and indexes from the databases. 

• ALTER is used to modify tables by adding fields or changing field definitions. 

These DDL statements can only be used with JET databases. They are not supported for any external 
database formats. OODBC currently does not support DDL statements. 

DML Commands 

• SELECT is used to query the database for records that satisfy specific criteria. 

• INSERT is used to load batches of data into the database in one operation or individually. 

• UPDATE is used to change the values of particular records and fields. 

• DELETE is used to remove records from a database table. 

SQL Data Types 

SQL precisely defines the types of data, which can be stored in its tables. The SQL standard types are as 
follows: 

Character: String of characters. Abbreviation: CHAR 
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Character returns the character with the ASCII value of expression. 
Number: Numbers with precision and scale may be specified. 

Decimal: Variant on the numeric theme but the precision is implementation-defined. Abbreviation: DEC. 
Decimal returns the numeric value of expression. 

Integer: Variant on the numeric theme but the precision is implementation-defined and the scale is 0. 
Abbreviation: INT. Integer returns the integer value of expression, by eliminating its decimal portion, if any. 

Smallint: Like INTEGER, SMALLINT has implementation-defined precision and a scale of 0. The only 
difference between the two types is that SMALLINT's precision must be less than INTEGER'S in any given 
implementation. No abbreviation for SMALLINT. 

Float: Approximations of floating point numbers. Table creator may again specify a precision for the values kept 
in this type of column. Float returns the floating-point value of expression. 

Real: Approximation of floating point numbers. REAL differs from FLOAT in that its precision is implementation- 
defined. 

Double- Approximations of floating point numbers. Has implementation-defined precision 

Precision: like REAL, however, the precision of REAL must be less that that of DOUBLE-PRECISION. 

Date: Date returns the date at the number of days since January 1st of the Year Zero equal to the value of 
expression. If an argument of three valid integers in order year, month, and day is passed separated by 
commas, the specified date is returned. 

Day: Returns the day (of the month) component of the date at the number of days since January 1st of the Year 
Zero equal to the value of expression. 



Description of the Syntax Symbols 



{A} A is optional; 

{ A I B } Either A or B may be provided 

{ A } A may be provided 0 or more times consecutively. 

{ A I B } Either A or B may be provided 0 or more times consecutively. 

Multiple values must be separated by commas. 
[AIB] Either A or B must be provided. 

[ A I B ] Either A or B must be provided at least once with no maximum number of occurrences, but 

multiple values must be separated by commas. 



Definitions of some SQL/ODBC Commands 



SELECT retrieves data from a table. 



Syntax: 



SELECT 
FROM 
{WHERE 
{GROUP BY 
{ HAVING 
{ ORDER BY 



{ DISTINCT I ALL }[ * I [column_expression]...] 

[ table_identifier { alias} ]... 

condition } 

[column_identifier]... 

condition }} 

[ ordering ] ...} 
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where 



column expression 
table-identifier 
owner. view_name] 
condition 



Expression 

comparison_operator 

subquery 



arithmetic operator 
alphanumeric_expression 



Constant 
Mask 



having_expression 

columnjdentifier 

having_condition 



expression 



Ordering 
function 



::= [ tablej'dentifier.* I expression I function I NULL ] 
::= [table_name I view_name I owner.table_name 

::= [expression comparison_operator [expression I subquery] 

I expression {NOT} BETWEEN expression AND 

expression I expression {NOT} IN ([constant]...) 

I expression {NOT} IN (subquery) 

I expression comparison operator [ANY I ALL I SOME ] 

(subquery) 

I alphanumeric_expression {NOT} LIKE mask 

I having_expression IS {NOT} NULL 

I EXISTS (subquery) I NOT condition 

I condition [AND I OR] condition I (condition) ] 

::= [arithmetic_expression I alphanumeric_expression] 

::= [= I < I > I <= I >= I <> ] 

::= a SELECT statement within a SELECT statement and may 
be used in conjunction with the IN, ANY and EXISTS 
operators. (A correlated subquery was defined as a subquery 
naming a column that belongs to a table which is specified in 
another query block.) 
::=[*!/ 1 + I-] 

::= [numeric_constant I columnjdentifier 
I arithmetic_expression arithmetic_operator 
arithmetic_expression I (arithmetic_expression)] 
::= [integer_constant I decimal_constant 
I floating_point_constant I alphanumeric_constant] 
::= I percent sign and another constant stands for 0 or 
more random charactersl underscore stands for exactly 
one character I appears after a LIKE operator 
::= [ expression I function ] 

::= [ columnjiame I tabeljdentifier I owner.columnjiame ] 
::= [having_expression comparison_operator [expression 
I subquery] 

I having_expression {NOT} BETWEEN expression AND 

I having_expression {NOT} IN ([constant]...) 

I having_expression {NOT} IN (subquery) 

I having_expression comparison_operator 

[ANY I ALL I SOME ](subquery) 

I alphanumeric_expression {NOT} LIKE mask 

I having_expression IS {NOT} NULL 

I EXISTS (subquery) I NOT having_condition 

I having_condition [AND I OR] having_condition 

I (having_condition) ] 

::= [columnjdentifier I column_sequencej"iumber] 
{ASC & DESC} 

::= [ [ COUNT I MIN I MAX I SUM I AVG ] 
( { DISTINCT } expression ) I COUNT (*) ] 
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SELECT statement with UNION: 

Syntax: SELECT [ * I [column_expression]...] FROM [ table_identifier { alias} ]... 

{ WHERE condition }...{ GROUP BY [column_identifier]...{ HAVING condition } } 
UNION 

SELECT [ * I [column_expression]..] FROM [ table_identifier { alias} ]... 
{ WHERE condition }...{ GROUP BY [column_identifier]... 
{ HAVING condition } }...{ ORDER BY [ ordering ] ...} 

The end results of the SELECT statements can be placed together underneath one another using the UNION 
operator. Union merges the tables resulting from two or more select statements into a single table. Rules for 
using the UNION operator: 

• An equal number of columns must be specified in the SELECT statements. 

• Columns that will be combined in the result table must have the same data type. 

• The ORDER BY clause can only appear in the last SELECT statement. 

• The SELECT clauses may not use the keyword DISTINCT because the duplicate rows are 
automatically removed when performing an UNION. 

A Subquery is a SELECT statement nested inside a SELECT, SELECT ...INTO, INSERT INTO, DELETE or 
UPDATE statement or inside another subquery. 

::= SELECT [column_expression] FROM [table_identifier] 

{ WHERE condition using ANY i ALL I SOME} 

SELECT [column_expression] FROM [table_identifier] 

{ WHERE condition }... HAVING condition. ..ORDER BY clause. 

The Subquery statement must refer to only one column, the data type of which must be compatible with the 
data type of expression. The WHERE clause in the subquery provides a condition which is always TRUE, 
therefore the subquery always returns rows. 

Nested Sub-Selects ( SubQueries): 

Example: Select the company names and order dates of the least recent orders. 

SELECT 'Order Date', Customers.'Company Name" FROM Customers Customers, Orders O WHERE 
Customers/Customer ID' = O/Customer ID' and O/Order Date' IN (SELECT Min( P/Order Date') FROM 
Orders P) 

A Crosstab query lets select values from specified fields or expressions as column heading so that the data 
can be viewed in a more concise format. 

::= TRANSFORM [aggregate function] SELECT statement 

PIVOT [pivot field] [IN (value 1 , value 2 ...)] 

A pivot field is a field or expression you want to use to create columns ( via the fixed values ) in the query's 
result set. 

Clauses 

Clauses are modifying conditions used to define the data you want to select or manipulate. 

The FROM clause identifies which table (view ) or tables (views) are to be accessed when the SELECT 
statement is processed. Two tables may have the same name if they belong to different owners. If you refer to a 
table (view) belonging to another owner, you must specify the owner name before the table (view) name. An 
alias is specified after the table identifier, if required. If an alias name has been specified for a table (view), it 
must be used in all relevant statements instead of the original table (view) name. 
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The rows required for the final result are defined in a condition in the WHERE clause. 
A condition can take the following forms: 

• Simple comparison 

• Coupled with AND, OR and NOT 

• BETWEEN, IN, LIKE, NULL, ANY, ALL, SOME and EXISTS operators 

• Comparison and IN operator with subquery 

The GROUP BY clause groups rows of an intermediate result of the FROM clause on the basis of equal value 
columns. You can group by more than one column. A group by clause is optional but may never come before a 
WHERE or FROM clause. 

The HAVING clause selects the groups of an intermediate result of the GROUP BY clause on the basis of 
particular group characteristics. Each expression in a having condition may contain one or more functions 
(COUNT, MIN, MAX, SUM, AVG) which perform particular calculations on the values in a column. A HAVING 
clause may only be used if a GROUP BY clause is also present. 

The ORDER BY clause sorts the final and remaining rows on the basis of the values in one or more columns 
but does not actually change the contents of the results. An ORDERBY clause is always last. 

Comparison Operators 

Comparison operators are used to compare the relative value of two expressions to determine what action 
should be taken. 

ANY compares the value of an expression with any of the values returned by a subquery statement. The 
operator may be any of: =equal to, >=greater than or equal to, >greater than, <=less than or equal to, <less 
than, <>not equal to. 

ALL compares the value of an expression with all the values returned by a subquery statement and all true 
results will be returned. 

SOME is true only if expression is true (using whichever operator is specified) when compared with any of the 
values of the column in the subquery statement. 

IN compares a value with the values of constants. A set may only contain distinct constants of the same data 
type. 

IN compares a value with the results of the subquery statement listed in a set. 

EXISTS tests for any row that satisfies the subquery criteria. The test is true if the subquery results in at least 
one row being selected and false if the subselect results in no rows being selected. A SELECT statement with 
an EXISTS operator is seldom executed quickly. The EXISTS operator is usually avoided because 
reformulating IN statement or JOINS cannot always be done. 

BETWEEN tests if a value of an expression is between the values of two other expressions. If this value is 
between the values of two other expressions then the result is true. 



LIKE compares expression 1 with expression2. You may use an asterisk (*) as a substitute for an unspecified 
number of characters (including no characters at all), and you may use a question mark (?) to substitute for a 
single unspecified character in expression2. 

The NULL operator tests for empty rows in a particular column. The Statement: A is NOT NULL is equivalent to 
NOT (A is NULL), where A is an expression. 
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Logical Operators 

Logical operators are used to connect expressions, usually within a where clause. 

AND combines two predicates in the WHERE clause. The combined predicate is then true only if both of the 
individual predicates are true. 

NOT is usually used to negate a Boolean. 

OR is usually used to combine two Booleans. The combined Boolean is then true only if one or both of the 
individual Booleans are true. 



Aggregate Functions 

Aggregate functions are used within a SELECT clause on groups of records to return a single value that applies 
to a group of records. 

The COUNT function calculates the number of rows in an expression. Used with the keyword DISTINCT, 
COUNT only calculates the number of those rows with unique values in the expression. An expression may not 
contain any nested combination of functions. NULL values are not included in calculations with functions. 

The MIN (MAX) function calculates the lowest (highest) values of a particular column. The keyword DISTINCT 
can be used with MIN (MAX), but has no effect on the processing because duplicate values do not influence the 
lowest and highest values in a set. 

The SUM function calculates the sum of all the values in a given column. Used with the keyword DISTINCT, 
SUM only calculates the sum of the unique values in the given column. 

COUNT, MIN, MAX and SUM functions can only be applied to columns with numeric data type. 

The AVG function calculates the average of all the selected values in a particular column. It is usually part of 
another expression or a select-list. The expression must contain date or numeric type data and it must not 
include any aggregate functions. 

JOIN is used to join two or more tables together according to their relationship to create a new table containing 
information from both tables. Tables can be joined in three ways: 

Inner Join is used to create a query that includes matching records from the two tables. 

::= FROM tablel INNER JOIN table2 ON tablel.fielch = table2.field2. 

Left Join is used to create a left outer join which will include all the records from the first table plus any 
matching records from the second table. 

::= FROM tablel [LEFT] JOIN table2 ON tablel .fieldl = table2.field2 

Right Join is used to create a right outer join which will include all the records from the second table plus any 
matching from the first table. 

::= FROM tablel [RIGHT] JOIN table2 ON tablel .fieldl = table2.field2 

ASC sorts the results in ascending order. 

DESC sorts the results in descending order. 

DELETE ::= DELETE FROM table_identifier {WHERE condition} 
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Rows are removed from a table using the DELETE statement. The table definition still exists. 
If the WHERE clause is left out, all the rows are deleted from a table. 

Subqueries in the WHERE clause of a DELETE statement cannot refer to the values being deleted. 

INSERT ::= INSERT INTO table_identifier { ( [column_name]...) } 

VALUES ( [constant I NULL]...) 

Single-record append query syntax. New Rows are added (one at a time) to a table. 

INSERT ::= INSERT INTO table_identifier { ( [column_name]...) } 

SELECT statement 

Rows stored in another table are copied and added to the table named, thus creating a new table. You can also 
append a set of records from another table or query using INSERT INTO with the SELECT FROM clause. 

The following rules apply to the INSERT statement in addition to those applied to the INPUT statement: 

• The SELECT statement can include subqueries, a join, a group but cannot refer to the table into which new 
rows will be inserted. 

• The number of columns in the INSERT INTO clause must equal the number of columns expressions in the 
SELECT clause. 

• The data type of the column in the INSERT INTO clause must conform with the data type of the columns in 
the SELECT clause. 

• The INSERT statement can be used for changing data types, removing columns, renaming tables or 
columns and adding a Not Null column to a table. 

INPUT ::= INPUT table_identifier{ ( [column_name]...) } [const I NULL].. .END 

The INPUT statement is used to enter many new rows in one single operation. 
Rules applied to the INPUT statements: 

• Each row of data is entered on a new input line. When the input line ends with a dash, the data on the 
following line in the same row of the table is included. 

• The INPUT statement is always closed with an END. 

• It is not mandatory to specify column names. 

• The sequence in which the data is inserted can be altered by specifying the columns and entering the data 
values accordingly. 

• It is not necessary to insert values into every column with the INPUT statement but all NOT NULL columns 
must be included. 

• A NULL value is inserted into all the columns not named in the INPUT statement. 

UPDATE ::= UPDATE table_identifier 

SET [column_name = [expression I NULL]]... {WHERE condition} 

The UPDATE statement is used to alter the values in the rows of a table. 

Rules applied to the UPDATE statement: 

• An UPDATE statement always refers to a table. The WHERE clause identifies the rows to be updated and 
the SET clause attributes the new values to the column(s). 

• Updating values in columns on which an UNIQUE index has been defined can cause problems. (The index 
column is updated in the first row which makes it not UNIQUE anymore causing the processing to stop.) To 
avoid this problem, drop the relevant UNIQUE index, process the UPDATE and then recreate the index. 
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• For data consistency, an UPDATE has to be applied to all the tables in which the column to be updated 
resides. 

• An UPDATE on a key column can be run without any problems by first checking for problems using the 
SELECT statement to COUNT the number of rows to be affected by such an UPDATE. 

The DISTINCT predicate is used to omit records that contain duplicate data in the selected columns. The output 
of a recordset of a distinct query can not be updated and does not reflect changes made by other users. 

The TOP predicate returns a certain number of records that fall at the TOP or BOTTOM of a range specified by 
an ORDER BY clause. If the ORDER BY clause is not included, the query will return an arbitrary set of 25 
records from the specified table. 

ABSOLUTE returns the absolute value of an expression, where the expression has to be numeric: 
LOWER converts all letters for expression to lower case. 
LOW returns the lower 16-bit value of expression. 

MOD returns the value remaining after the largest multiple of expression2 that is less than expressionl is 
subtracted from expression2.This function is also called modulo division. 

MONTH returns the month (of the year) component of the date. 

SOME is true only if expression is true (using whichever operator is specified) when compared with any of the 
values of the column in the subquery statement. 

STRING converts expression, which may be of any data type, to a string. 
UPPER converts all letters of expression to upper case. 
YEAR returns the year component of the date. 



SQL / ODBC Query Examples 



Select all customer records. 

• SELECT * FROM CUSTOMER 

Select the company name, state and city of all customers. 

• SELECT CUSTOMER, STATE, CITY FROM CUSTOMER 

Select all the Data Access Corporation records. 

• SELECT * FROM CUSTOMER WHERE CUSTOMER = 'Zorro Cutlery' 
Select the names and addresses of all customers in California or Florida. 

• SELECT CUSTOMER, ADDRESS, STATE, CITY FROM CUSTOMER WHERE STATE = 'CA' OR STATE 
= 'FL' or 

• SELECT CUSTOMER, ADDRESS, STATE, CITY FROM CUSTOMER WHERE STATE IN ( 'CA', 'FL') 

Select all customer records whose customer_no is greater than 7. 

• SELECT * FROM CUSTOMER WHERE NUMBER > 7 

Select all customer records with customer numbers not equal to 15. 

• SELECT * FROM CUSTOMER WHERE NUMBER <> 15 
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Select the number, name and state of each customer who is situated in California and with profits between 
$1000 and $10,000. 

• SELECT NUMBER, CUSTOMER, STATE FROM CUSTOMER WHERE STATE = "CA" AND PROFIT >= 
1,000.00 <= 10,000.00 

Select the Customers' names and numbers whose name begins with A. 

• SELECT NUMBER, CUSTOMER FROM CUSTOMER WHERE CUSTOMER LIKE 'A%' 

Select the Customers' names and numbers whose name ends with r. 

• SELECT NUMBER, CUSTOMER FROM CUSTOMER WHERE CUSTOMER LIKE '%r' 

Select all the customers who have a customer_no. 

• SELECT * FROM CUSTOMER WHERE NUMBER is NOT NULL 

Select the order and detail numbers and display the results grouped by ascending order of order numbers and 
then by detail number. 

• SELECT ORDER NUMBER, DETAILNUMBER FROM ORDERDTL GROUP BY ORDER NO, 
DETAILNUMBER 

Select the salesmen who have made at least 3 orders. 

• SELECT SLSMN FROM ORDERHEA GROUP BY SLSMN HAVING COUNT(*) >3 

Find the salesmen and the total amount ordered via these salesmen with totals greater than $1000 

• SELECT O.SLSMN, SUM(OD.AMOUNT) FROM O. ORDERHEA, OD. ORDERDTL WHERE 
OD.ORDERNUMBER = O.ORDERNUMBER GROUP BY O.SLSMN HAVING SUM(OD.AMOUNT) > 
1000 

Find the measure of spread (range) of the total ordered amounts. 

• SELECT AVG(TOTAL) FROM ORDERHEA 

Group the customer numbers on the basis of the following criteria: 
Total amount ordered is less than $100.00 

Total amount ordered is greater than $150.00 and less than $1000.00 
Total amount ordered is greater than $5000.00 

• SELECT CUSTOMER NUMBER, TOTAL FROM ORDERHEA WHERE TOTAL < 1 00 OR TOTAL > 1 50 
AND TOTAL < 1000 OR TOTAL > 5000 GROUP BY TOTAL 

Find the maximum (minimum) amount spent on a particular event. 

• SELECT MAX(AMOUNT), EVENT FROM TRANSACT 

• SELECT MIN(AMOUNT), EVENT FROM TRANSACT 

Find the parts, salesman names, customer details, order and detail numbers for all orders with the detail 
number = 4. 

• SELECT C.CUSTOMER, C. ADDRESS, C.CITY, O.ORDER NUMBER, O.SLSMN, OD.DETAILNUMBER, 
OD.PARTJD FROM C.CUSTOMER, O. ORDERHEA, OD. ORDERDTL WHERE C. NUMBER = 
O.CUSTOMER NUMBER AND OD.ORDER NUMBER = O.ORDER NUMBER AND 
(OD.DETAILNUMBER = 4) 

Increase all discounts by 5%. 

• UPDATE CUSTOMER SET DISCOUNT = DISCOUNT * 1 .05 
Delete all orders made via JJT. 

• DELETE FROM ORDERHEA WHERE SLSMN = "JJT" 
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Find the names and codes of each customer and also give the parts sold to them. 

• SELECT CUSTOMER, NUMBER PARTJD FROM CUSTOMER A, ORDERHEA B, 
ORDERDTL C WHERE A. NUMBER = B.CUSTOMER NUMBER AND B.ORDER NUMBER 
= C.ORDERN UMBER 

Find the names and address details, order numbers and detail numbers of the parts ordered by a 
particular customer ordering the result by the order numbers in ascending order and detail 
numbers in descending order. 

• SELECT O.ORDERNUMBER, O.ORDER DATE, O.SLSMN, C.CUSTOMER, C. ADDRESS, 
C.CITY, OD. PARTJD, OD.DETAILNUMBER FROM CUSTOMER C, ORDERHEA O, 
ORDERDTL OD WHERE C. NUMBER = O.CUSTOMER NUMBER AND 

O.ORDER NUMBER = OD.ORDER NUMBER ORDER BY O.ORDER NUMBER ASC, 
OD.DETAIL NUMBER DESC 

Left Outer Join: (children with and without parents) 

• SELECT test."STATUS", test. "ST ATUSDATE",TEST2. "STATUS", TEST2."CUST_NAME" 

FROM { oj "test" test LEFT OUTER JOIN "TEST2" TEST2 

ON test."STATUS" = TEST2."STATUS"} 
ORDER BY TEST2."STATUS" ASC 

Right Outer (left reversed): (parents with and without children) 

• SELECT test."STATUS", test. "ST ATUSDATE",TEST2. "STATUS", TEST2."CUST_NAME" 

FROM { oj "test" test LEFT OUTER JOIN "TEST2" TEST2 

ON TEST2."STATUS" = test."STATUS"} 
ORDER BY TEST2."STATUS" ASC 



SQL Operators and Functions not yet Supported by Q ODBC 

Union Operator: 

Example: Select the company name, contact person and country of all customers in Belgium or 
Finland. 

SELECT Customers.'Company Name' FROM Customers Customers WHERE 
Customers.Country ='Belgium' UNION 

SELECT Customers/Company Name' FROM Customers Customers 
WHERE Customers.Country = 'Finland' 

BUT YOU CAN GET AROUND THIS PROBLEM BY USING IN ( SET OF FIELDS....) OR A JOIN. 
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Functions: 

• Concatenation and Trim 

Example: Concatenating the first and last names of the employees. 

SELECT TRIM(Employees.Tirst Name')* ' ' + TRIM(Employees. , Last Name') FROM 
Employees Employees 

• Ucase(NAME) or Upper(NAME) : Returns the name in upper case. 

• Lcase(NAME) or Lower(NAME): Returns the name in lower case. 

• Left(File. Fieldname, 3): Returns the 3 letters at the start of the fieldname. 

• Right(File. Fieldname, 3): Returns the 3 letters at the end of the fieldname. 

• Substr(File. Fieldname, 3, 5): Returns the 5 letters starting at the 3rd letter of the fieldname. 

• Space(20): Add spaces to fields. 

• Round(File. Fieldname, 2): Rounds the numeric field correct to 2 decimal places. 

• Truncate(File. Fieldname, 2): truncates the numeric field at the 2nd digit. 

• lnt(File. Fieldname): Returns the integer part of a numeric field 

• Len(File. Fieldname): Counts the number of characters in each name of the product. 

• Mod( Field. Fieldname): Returns the integer part of the quotient. ( Result to a division.) 

• Month-, Day-, Year(File.DateField): Returns the Month, day or year part respectively of the 
date field specified. 

• Date(): Return todays date. 

• Abs(file. Fieldname): Finds the absolute value of a numeric field Cos, Sin, Tan, Exp, Log, Sqr, 
Atan, Asin, Acos, Cos, Cot, Cosec, Square, Standard Deviation and Variance of samples or 
populations. 

Most of these functions emulate string manipulation tasks performed by programming languages, 
and therefore can be performed on the result data by MS Excel Macros or VB Script program 
code. 
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0 ODBC 2004 Frequently Asked Questions 



The Frequently asked questions about this product are constantly changing, so we have a web 
page setup with these questions. It can be found at: 

http://qodbc.com/QODBCfaq.htm 

QODBC Support 

This driver has the following ODBC support and limitations: 

• Only ODBC Core Level SQL is supported. 

• Only ODBC Level 2 API calls are supported. 

• ODBC Version 3.0 compliant. 

• Column and table names are not case-sensitive, string data comparisons are case sensitive. 

• Character values supplied for parameterized queries (SELECT * FROM EMP WHERE NAME 
= ?) are limited to 255 characters. 

• Transactions are not supported. 

• Qualifiers and owners are not allowed on databases, tables, etc. 

• Table creation and deletion are not supported currently. 

Windows Support 

This product supports Microsoft Windows 95, Windows 98, Windows NT, Windows ME, Windows 
2000, Windows XP and higher. 



Product Support 



We offer a free fully functional trial copy of QODBC limited to selected elements in the 
QuickBooks system. A FAQ section and a free support knowledgebase is available for those 
evaluating QODBC. Those purchasing the product will receive Free support for 30 days from the 
date of purchase. Program anomalies will be addressed at no charge and updaters posted on our 
web site. Other issues may be subject to a fee. 



Support can be obtained by the following methods: 

Mail: FLEXquarters 

6965 El Camino Real Ste 105 #488 
Carlsbad, CA 92009 USA 

Online Support: http://www.qodbc.com/ 

E-mail: mailto:info(a>qodbc.com 

Newsgroups http://qodbc.com/support.htm 

Fax/Voice: (602)532-7019 



The most effective of these methods is e-mail support by Internet, since you can attach an ODBC 
trace log to the message, and we can attach an updated product to you if we have a patch. 

Before contacting us, run an ODBC trace log of the operations you are having problems with and 
contact the vendor of your application to see if they are driver related problems. If they are, send 
us the file and a description of the problem. 
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Product Updates 



Since the product is distributed in Demo form, the latest updated versions will always be available 
on-line at our web page: 

http://www.qodbc.com/ 



QODBC Credits 

0 ODBC version 2.x, 3.x, 4.x or higher. 

For Microsoft Windows 95, Windows 98, Windows ME, Windows NT, Windows 2000 Windows 
XP and higher. 

© Copyright 1995-2004, FLEXquarters, All Rights Reserved Worldwide 

Portions of this product© Copyright Intuit Incorporated 
0 ODBC is a trademark of FLEXquarters 

QuickBooks Pro and QuickBooks Premier are registered trademarks of Intuit Incorporated 
Windows is a registered trademark of Microsoft Corporation 
All other trademarks are copyrights of their respective holders 



Version 2.0 First released October 2002 
Version 3.0 First released January 2003 
Version 4.0 First released November 2003 



Program published and supported by: 
FLEXquarters 

6965 El Camino Real Ste 105 #488 
Carlsbad, CA 92009 USA 



WWW: http://www.qodbc.com/ 
E-mail: info@qodbc.com 
Fax/Vo ice : (602) 532-701 9 



FLEXquarters Sales Office: 

FLEXquarters USA Sales 
1706 Point Drive 
Commerce, Ml 48382 



E-mail: mark@flexquarters.com 

Voice: 800-932-6448 (In the US) or 248-360-7842 

Fax: 248-360-9567 

Technical Support 248-360-8891 



Program developed by Brad Waddell and Matthew Froncek 

Documentation produced by Mark Kuznar, Linda Shember, Brad Waddell and Matthew Froncek. 
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